RTF-Konverter fuer MS-Word Dateien der Formate 2,6,7 (=95),8 (=97)
------------------------------------------------------------------
Version 1.35
(C) Stephan Lentz 1997/98/99/2000

Unterstuetzte Plattformen:
--------------------------

OS/2    (DOC2RTF.EXE)
TOS     (DOC2RTF.PRG)
Windows (DOC2RTFW.EXE)
Linux   (doc2rtfl.exe)

Aufruf:
-------

doc2rtf [<Parameter>] <Word-Datei> [<RTF-Datei>] [<Logdatei>]

Die Reihenfolge der Angaben ist beliebig, die Dateien werden anhand ihrer
Erweiterungen (.DOC/.RTF) erkannt.

Ohne Angabe einer RTF-Datei wird der Name der Word-Datei verwendet, wobei 
DOC durch RTF ersetzt wird. (Unter Linux durch rtf)

Wird eine Logdatei angegeben, so werden alle Bildschirmausgaben in diese
Datei geschrieben. Der Name der Logdatei muss auf .LOG enden.

Parameter:
----------

-pb Bilder binaer statt hexadezimal ausgeben
-nd Temporaere Datei (ab Word 6 fuer OLE-Extraktion noetig) nicht loeschen
-tf Schnellspeicherflag nicht beachten (nur noch fuer Word 2 interessant)
-et Fehlermeldungen in Text einfuegen
-we Bei Fehler nach Programmende kurz warten

Rueckgabewerte:
---------------

"Kein Fehler",                                     /*  -0 */
"Zu wenig Parameter",                              /*  -1 */
"Ungueltige Dateiendung der WORD-Datei",           /*  -2 */
"Kann WORD-Datei nicht oeffnen",                   /*  -3 */
"Fehler im RTF-Pfad",                              /*  -4 */
"Ungueltige Dateiendung der RTF-Datei",            /*  -5 */
"Kann RTF-Datei nicht oeffnen",                    /*  -6 */
"Schreibfehler - Disk voll?",                      /*  -7 */
"Nicht genug Speicher",                            /*  -8 */
"Unerwartetes Ende der WORD-Datei",                /*  -9 */
"Formatfehler der WORD-Datei",                     /* -10 */
"Dateifehler beim Zugriff auf die WORD-Datei",     /* -11 */
"Fehler in Fontliste",                             /* -12 */
"Fehler in Stylesheet",                            /* -13 */
"Abbruch auf Benutzerwunsch",                      /* -14 */
"Kann temporaere Datei nicht loeschen",            /* -15 */
"Nicht unterstuetze WORD-Version",                 /* -16 */
"Dateien im Schnellspeicherformat",                /* -17 */
"Fehler in Formattabelle",                         /* -18 */
"Kann keine temporaere Datei anlegen - Disk voll?",/* -19 */
"OLE-Extraktionsfehler",                           /* -20 */
"GEM-Initialisierung gescheitert",                 /* -21 */
"Datei ist keine OLE-Datei (fehlerhafte ID)",      /* -22 */
"Stream in OLE-Datei nicht gefunden"               /* -23 */

History:
--------

Version 1.35 vom 30.5.2000:
* Bug beseitigt: Bei extrem grossen Dateien wurde die Zeichenzahl unter
  Unstaenden falsch eingetragen.

Version 1.34 vom 6.2.2000:
* Anpassung auf Linux
* Die Anzahl der Anschlaege wird in der RTF-Datei in der Info-Gruppe unter 
  \nofchars ausgegeben. Dabei werden Leerzeichen und Returns mitgezaehlt.

Version 1.33 vom 21.4.99:
* Bug in der Berechnung des Zeilenabstands korrigiert. War schon ewig drin.
* Neuer Befehl \picwrN (N=1..3) fuer Umfluss von Bildern aus Draw Objekten.
* Schnellgespeicherte Dateien werden fuer Word 6,7,8 nicht mehr mit Fehler 
  zurueck gewiesen, sondern erhalten im Header der RTF-Datei das Control word
  "\fastsave". Dabei wird der Text korrekt uebersetzt, evt. kann aber die 
  Formatierung noch abweichen.
* Im Header der RF-Datei erscheint das Control word \doctortfN, wobei N die
  dreistellige Versionsnummer ist.
* Undokumentierte PNG-Abart mit msobi-Kennung 0x6E1 (statt 0x6E0) wurde
  provisorisch implementiert. Kam aber bisher nur einmal vor, deshalb unsicher.

Version 1.32 vom 16.4.99:
* Schnellgespeicherte Dateien werden zumindest vom Text her erkannt (Aenderungen
  an den Formatierungen noch nicht)
* Unterstuetzung von Symbolen in Word 6/7

Version 1.31 vom 15.4.99: 
* Umstellung FC->CP fuer Word 6/7

Version 1.30 vom 14.4.99: 
* Bugfix: Seit einigen Versionen wurden Teile des Textes nicht uebersetzt, die 
  nach einem Feld ohne "RESULT"-Teil kamen, und zwar wurde alles bis zum naechsten 
  Feld mit Result-Teil unterdrückt.

Version 1.29:
* Optimierung: Einlesen des Textes aus Datei gepuffert

Version 1.27:
* Korrekte Unicode-Auswertung in Word 8 Dateien. Umstellung FC->CP fuer Word 8

Version 1.20 vom 15.3.99:
* Word 8 Unterstuetzung.
* Fuer Word97 werden Word-Grafiken soweit moeglich, als WMF exportiert

Version 1.17 vom 10.7.98:
* Neuer Parameter -tf verhindert die Fehlermeldung "Schnellgespeicherte Dateien werden nicht
  unterstuetzt" bei gesetztem Fastsave-Flag. 
  So kann nach dem ersten Aufruf des Konverters und der Fehlermeldung INDATCOMPLEX eine
  entsprechende Frage an den Benutzer erfolgen, ob das Laden trotzdem versucht werden soll.
  Natuerlich ist nach erfolgreichem Laden dann auch der Hinweis angebracht, dass das 
  dargestellte Dokument vom tatsaechlichen abweichen kann.
* Neuer Parameter -et fuegt Fehlermeldungen in der Form ***FEHLER: ...*** in den Text ein,
  falls ungueltige Zeiger o.ae. entdeckt werden; siehe auch folgende zwei Punkte.
* Bugfix: Wenn Feldende oder Feldtrenner ohne vorhergehenden Feldanfang auftaucht, wird 
  kein }} mehr geschrieben, sondern eine entsprechende Fehlermeldung in den Text eingefuegt.
* Bugfix: Die Adresszeiger und Laengen von Bilddateien werden jetzt geprueft, bevor die 
  Bildinfos geschrieben werden. Bei einem Fehler wird eine entsprechende Fehlermeldung in 
  den Text eingefuegt.

Version 1.16 vom 6.7.98:
* Workaround eines Library-Fehlers des OS/2-Compilers (in fseek). Fuehrte manchmal zu der 
  Fehlermeldung "Unerwartetes Ende der Datei"
* Word 8 Dateien werden erkannt, aber noch nicht konvertiert.
* Fuer Debug-Zwecke: Parameter -nd verhindert das Loeschen der temporaeren Datei, 
  die ab Word 6 angelegt wird, um die aus der OLE-Datei extrahierten Word-Daten zwischenzuspeichern.
* Fehler in ATARI-Version beseitigt, der zur Beschneidung von grossen Dokus fuehrte

Version 1.15 vom 2.7.98:
* OLE-Extraktion unter OS/2 und TOS stark verbessert

Version 1.14 vom 16.4.98:
* Erkennung der Seitennumerierung verbessert (wurde oefters nur als Feld exportiert)
* Erkennung fester Leerzeichen unter Win 95 ging nicht (Problem mit Compiler)
* Absolut positionierte Absaetze nun auch mit negativer Position relativ zum Bezugsrahmen

Version 1.13 vom 1.2.98:
* Die Windows-Version verwendet jetzt die OLE-API. Dadurch keine Extraktionsfehler mehr.

Version 1.12 vom 30.11.97:
* Parameter -pb funktioniert wieder (gab \picN statt \binN aus)

Version 1.11 vom 14.11.97:
* In Word-2-Dateien Zeichen die kleiner als ' ' oder groesser als 7F in der Form \'XX exportiert
* Nach \'XX-codierten Zeichen wurde manchmal ein ueberfluessiges Leerzeichen eingefuegt
* Zwei Fehlermeldungen in detect_version auf den korrekten Fehler OLEERR gesetzt

Version 1.10 vom 23.09.97:
* Angepasst an alle Plattformen
* Parameter -pb bewirkt die Ausgabe von Bildern im Binaer-Format

